home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d18 / spool100.arc / SPOOLER.MAN < prev    next >
Text File  |  1990-04-29  |  5KB  |  98 lines

  1.   Prima che una applicazione utilizzi le funzioni della SPOOLER UNIT e`
  2. necessario che da DOS venga installato PRINT, con un comando di questo tipo:
  3.  
  4.     PRINT /D:LPT1 /Q:32     (Tutte le richieste di stampa a PRINT vengono evase
  5.                              da LPT1 e la coda puo` contenere fino a 32
  6.                              pathnames)
  7. ==============================================================================
  8. var SpoolerResult : word;
  9.     ^^^^^^^^^^^^^
  10.  
  11.    Questa variabile puo` essere usata per verificare se l'ultima operazione
  12. richiesta a PRINT e` andata a buon fine (SpoolerResult=0):
  13.  
  14.      se l'operazione non e` andata a buon fine in seguito al fallimento di una
  15.      verifica su SpoolerStatus i possibili valori sono:
  16.  
  17.        SPOOLER_NOT_INSTALLED         PRINT non e` stato installato
  18.        SPOOLER_CANNOT_BE_INSTALLED   PRINT non e` stato installato e
  19.                                            non puo` essere installato
  20.  
  21.      se l'operazione non e` andata a buon fine in seguito al settaggio del
  22.      CARRY FLAG da parte di una delle funzioni di PRINT i possibili valori (da
  23.      me ottenuti) sono:
  24.  
  25.        QUEUE_FULL                    una richiesta a SubmitFileS non e` stata
  26.                                      soddisfatta (almeno non completamente)
  27.                                      perche' i files accodati e non ancora
  28.                                      stampati hanno raggiunto il massimo
  29.                                      definito installando PRINT (/Q:nn) e si e`
  30.                                      tentato di accodarne di piu`.
  31. -------------------------------------------------------------------------------
  32. function SpoolerStatus : word;
  33.          ^^^^^^^^^^^^^
  34.  
  35.   Questa funzione e` usata soprattutto all'interno della SPOOLER UNIT, ma e`
  36. utile per verificare se PRINT e` stato installato.
  37.  
  38.   I possibili valori di ritorno sono:
  39.  
  40.     SPOOLER_INSTALLED             PRINT e` stato installato
  41.     SPOOLER_NOT_INSTALLED         PRINT non e` stato installato
  42.     SPOOLER_CANNOT_BE_INSTALLED   PRINT non e` stato installato e
  43.                                         non puo` essere installato
  44. -------------------------------------------------------------------------------
  45. procedure SubmitFileS (WildCString : EntryType; var Queue : QueueType);
  46.           ^^^^^^^^^^^
  47.  
  48.   Questa procedura si occupa di accodare i files identificati da WildCString
  49. (puo` contenere delle wild cards '?' e '*').
  50.  
  51.   Il pathname viene espanso, quindi se WildCString='..\DOC\SPOOL*.*' e il
  52. drive/directory corrente e` 'C:\TP\SRC' verra` richiesto a PRINT di accodare
  53. tutti i files identificati da 'C:\TP\DOC\SPOOL*.*'.
  54.  
  55.   Al ritorno dalla procedura l'array di stringhe passato come var Queue
  56. contiene i nomi (espansi) di tutti i files accodati da questa chiamata a
  57. SubmitfileS (se Queue non e` pieno la stringhe successive all'ultima
  58. significativa hanno length()=0); se tutti i files identificati da WildCString
  59. hanno trovato posto nella coda SpoolerResult vale 0 altrimenti SpoolerResult
  60. vale QUEUE_FULL.
  61. -------------------------------------------------------------------------------
  62. procedure CancelFiles (WildCString : EntryType);
  63.           ^^^^^^^^^^^
  64.   Questa procedura si occupa di togliere i files identificati da WildCString
  65. (puo` contenere delle wild cards '?' e '*') dalla coda.
  66.  
  67.   Il pathname viene espanso quindi se WildCString='..\DOC\SPOOL*.*' e il
  68. drive/directory corrente e` 'C:\TP\SRC' verra` richiesto a PRINT di togliere
  69. dalla coda tutti i files identificati da 'C:\TP\DOC\SPOOL*.*'.
  70. -------------------------------------------------------------------------------
  71. procedure CancelAllFiles;
  72.           ^^^^^^^^^^^^^^
  73.   Questa procedura svuota la coda di stampa; se il drive/directory corrente e`
  74. lo stesso di quando e` stata chiamata SubmitFileS equivale a:
  75.  
  76.     CancelFiles('*.*');
  77. -------------------------------------------------------------------------------
  78. procedure ListQueue (var Queue : QueueType);
  79.           ^^^^^^^^^
  80.   Al ritorno dalla procedura l'array di stringhe passato come var Queue
  81. contiene i nomi (espansi) di tutti i files accodati dalle varie chiamate a
  82. SubmitfileS e non ancora stampati (la prima stringa contiene il pathname del
  83. file in stampa e le successive i pathnames dei files in coda).
  84.  
  85.  Se Queue non e` pieno le stringhe successive all'ultima significativa hanno
  86. length()=0).
  87. ==============================================================================
  88.  
  89.   Questa UNIT (tutti i files SORGENTI, OGGETTO e di DOCUMENTAZIONE) e` di
  90. PUBBLICO DOMINIO.
  91.   E` liberamente copiabile e modificabile ma, d'altra parte, non rispondo di
  92. eventuali errori; comunque chi ne rilevasse e` pregato di segnalarmeli cosi`
  93. che possa correggerli.
  94.   Se la distribuite ad altri includete tutti i files sopra elencati.
  95.   Se la modificate cercate di includere tutti i files sopra elencati piu` la
  96. vostra versione modificata.
  97.  
  98.